package com.jiangyg.mall.product.service;

import com.jiangyg.mall.core.support.restful.Pagination;
import com.jiangyg.mall.core.utils.tree.Tree;
import com.jiangyg.mall.product.dto.CategoryDTO;
import com.jiangyg.mall.product.vo.CategoryVO;

import java.util.List;

/**
 * 类描述：商品三级分类
 *
 * @author jiangyg
 * @email email@jiangyg.com
 * @date 2021-10-18 22:25:29
 */
public interface CategoryService {

    /**
     * 功能描述：获取目录树形结构
     * <p>用于商城首页分类目录，只显示最精简的数据</p>
     *
     * @return 目录树形结构
     */
    List<Tree> tree() throws Exception;

    /**
     * 功能描述：获取后台管理的目录树形结构
     *
     * @return 目录树形结构
     */
    List<Tree> mtree() throws Exception;

    /**
     * 功能描述：商品三级分类分页查询
     *
     * @param pagination 分页参数
     * @return 返回分页信息
     */
    Pagination<CategoryDTO> selectPagination(Pagination<CategoryDTO> pagination) throws Exception;

    /**
     * 功能描述：保存或者修改商品三级分类
     *
     * @param dto 商品三级分类
     * @return 返回是否操作成功
     */
    boolean saveOrUpdate(CategoryDTO dto) throws Exception;

    /**
     * 功能描述：根据ID获取Category
     *
     * @param categoryId 商品三级分类ID
     * @return 返回商品三级分类
     */
    CategoryVO selectById(Long categoryId) throws Exception;

    /**
     * 功能描述：批量删除Category
     *
     * @param categoryIds 要删除的ID数组
     * @return 返回是否操作成功
     */
    boolean delete(List<Long> categoryIds);

}

